home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xm / XmGetScaledPixmap.z / XmGetScaledPixmap
Encoding:
Text File  |  2002-10-03  |  5.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmGGGGeeeettttSSSSccccaaaalllleeeeddddPPPPiiiixxxxmmmmaaaapppp((((3333XXXX))))     UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV     XXXXmmmmGGGGeeeettttSSSSccccaaaalllleeeeddddPPPPiiiixxxxmmmmaaaapppp((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmGGGGeeeettttSSSSccccaaaalllleeeeddddPPPPiiiixxxxmmmmaaaapppp - read a pixmap file and scale it
  10.           according to pixmap and print resolution
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/Xm.h>
  14.           XXXXttttEEEEnnnnuuuummmm XXXXmmmmGGGGeeeettttSSSSccccaaaalllleeeeddddPPPPiiiixxxxmmmmaaaapppp(
  15.           WWWWiiiiddddggggeeeetttt wwwwiiiiddddggggeeeetttt,
  16.           SSSSttttrrrriiiinnnngggg iiiimmmmaaaaggggeeee____nnnnaaaammmmeeee,
  17.           PPPPiiiixxxxeeeellll ffffoooorrrreeeeggggrrrroooouuuunnnndddd,
  18.           PPPPiiiixxxxeeeellll bbbbaaaacccckkkkggggrrrroooouuuunnnndddd,
  19.           iiiinnnntttt ddddeeeepppptttthhhh,
  20.           DDDDoooouuuubbbblllleeee ssssccccaaaalllliiiinnnngggg____rrrraaaattttiiiioooo);
  21.  
  22.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.           XXXXmmmmGGGGeeeettttSSSSccccaaaalllleeeeddddPPPPiiiixxxxmmmmaaaapppp uses its _W_i_d_g_e_targument to look up for a
  24.           Print Shell ancestor to get the pixmap resolution and the
  25.           default printer resolution information to be used if
  26.           _s_c_a_l_i_n_g__r_a_t_i_o========0000.
  27.  
  28.           If scaling is 0, and a valid PrintShell is present
  29.           XXXXmmmmGGGGeeeettttSSSSccccaaaalllleeeeddddPPPPiiiixxxxmmmmaaaappppapplies a ratio equals to (printer
  30.           resolution / default pixmap resolution) before creating the
  31.           Pixmap on the widget's Screen.  Otherwise, the
  32.           _s_c_a_l_i_n_g__r_a_t_i_ois used in scaling both dimensions of the image
  33.           being converted as a Pixmap.
  34.  
  35.           XXXXmmmmGGGGeeeettttSSSSccccaaaalllleeeeddddPPPPiiiixxxxmmmmaaaapppp completes the XXXXmmmmGGGGeeeettttPPPPiiiixxxxmmmmaaaappppBBBByyyyDDDDeeeepppptttthhhh existing
  36.           API by making use of the _X_m_N_d_e_f_a_u_l_t_P_i_x_m_a_p_R_e_s_o_l_u_t_i_o_nof the
  37.           rooting XXXXmmmmPPPPrrrriiiinnnnttttSSSShhhheeeellllllll.  Refer to the XXXXmmmmGGGGeeeettttPPPPiiiixxxxmmmmaaaappppBBBByyyyDDDDeeeepppptttthhhh
  38.           documentation for details.
  39.  
  40.           _w_i_d_g_e_t    Widget used to determine the default pixmap
  41.                     resolution (of the print shell ancestor).
  42.  
  43.           _i_m_a_g_e__n_a_m_e
  44.                     See XmGetPixmapByDepth for description.
  45.  
  46.           _f_o_r_e_g_r_o_u_n_d
  47.                     See XmGetPixmapByDepth for description.
  48.  
  49.           _b_a_c_k_g_r_o_u_n_d
  50.                     See XmGetPixmapByDepth for description.
  51.  
  52.           _d_e_p_t_h     See XmGetPixmapByDepth for description.
  53.  
  54.           _s_c_a_l_i_n_g__r_a_t_i_o
  55.                     Indicate the scaling ratio to be applied, or 0.
  56.  
  57.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  58.           Returns Pixmap or NULL if failed.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmGGGGeeeettttSSSSccccaaaalllleeeeddddPPPPiiiixxxxmmmmaaaapppp((((3333XXXX))))     UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV     XXXXmmmmGGGGeeeettttSSSSccccaaaalllleeeeddddPPPPiiiixxxxmmmmaaaapppp((((3333XXXX))))
  71.  
  72.  
  73.  
  74.      EEEERRRRRRRROOOORRRRSSSS////WWWWAAAARRRRNNNNIIIINNNNGGGGSSSS
  75.           Same as for XXXXmmmmGGGGeeeettttPPPPiiiixxxxmmmmaaaappppBBBByyyyDDDDeeeepppptttthhhh.
  76.  
  77.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  78.           XXXXmmmmPPPPrrrriiiinnnnttttSSSSeeeettttuuuupppp(3), XXXXmmmmPPPPrrrriiiinnnnttttSSSShhhheeeellllllll(3), XXXXmmmmRRRReeeeddddiiiissssppppllllaaaayyyyWWWWiiiiddddggggeeeetttt(3)
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.